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I INTRODUCTION 

The QM MICROASSEMBLER ts a mam store program written for the emulated 
"NOVA" computer to satisfy two assembly language processing needs: 

- assembly of QM/SYSTEM control store microprograms. 

- assembly of "NOVA" format assembly language programs. 

The QM MICROASSEMBLER will be referred to by the name "MICRO" throughout 
tht s manua I ♦ 

This manual provides source language specifications and operating instruct- 
ions for programmers writing either class of program. NOVA format assembly 
capability is provided for those maintaining or modifying the NANODATA 
CONTROL SYSTEM CNCS), which is written utilizing NOVA type instructions. 
Beyond that, MICRO is extensible and will be restructured, dynamically, to 
conform to any of the microprogramming architectures defined for execution 
on the QM/SYSTEMS. 

It is assumed that the reader is familiar with the terminology and operat- 
ion of the NANODATA CONTROL SYSTEM. Additional information on NCS is pro- 
vided in the QM - NCS OPERATIONS GUIDE. 

1.1 OVERVIEW 

MICRO is a conventional two pass assembler with special provision for the 
definition of microinstruction operation codes, formats and constants when 
used for the assembly of QM/SYSTEM microprograms. 

Two NCS files are used as input. They are: 

DEF - a binary output file from a QM/SYSTEM Nanoassemb t y, containing 
the definition of microinstruction operation codes, formats and 
constants. This file can be omitted when assembling NOVA programs. 
Up to four DEF files can be assigned for each assembly* 

INPT - a source file containing the source program to be assembled. 
This file is always required. An additional three files may, 
optionally, be assigned to INPT as symbolic definition files. 
These fifes will not produce any generated object code, but will 
provide common symbolic values for reference during the assembly. 

One NCS file is produced as output. It iss 

BIN - a loadable format, binary output file of the assembled object 
program. This file may be omitted if only an assembly check, or 
listing, is desired. 

An optional printer listing is also produced as a result of an assembly. 
This listing shows the object code addresses, the assembled object code, 
and the source statements, along with an indication of any errors detected 
during the assembly. 

An alphabetized summary of all operation codes and all symbolic names may 
be listed, optionally, at the end of the assembly. 
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1.2 ASSEMBLER ORGANIZATION 

MICRO consists of four baste phases. These ares 

1) DEFINITION phase - the DEF file (if any) is processed and a symbol 
table is constructed for the microinstruction operation codes and 
constants appropriate to the microprogram environment for which the 
assembly is to be done. If no DEF file is specified, MICRO assumes 
that the assembly is to be of a NOVA type program, and built-in 
symbol tables and formats appropriate to the NOVA architecture are 
used • 

2) PASS 1 - The INPT files are processed and all labels are evaluated 
and placed into the symbol tables. Memory space is allocated 
through use of a m tc ro~l ocat ton-counter , which is incremented each 
time a memory word is generated. The vafu.es assigned to Labels are 
usually that which is found in the m i cro-l ocat i on-counter as Labels 
are encountered. 

3) PASS 2 - the primary (first) INPT file is again processed and the 
object code corresponding to each statement is generated. If 
specified, the BIN file is produced during this phase. The output 
listing is also produced if desired. 

4) SUMMARY phase - the symbol tables are scanned to produce an alpha- 
betized listing of the operation codes and symbolic names used in 
the program. 

1.3 UTILIZATION 

MICRO is designed to operate under the NANODATA CONTROL SYSTEM* utilizing 
input / output and loader facilities provided therein. An assembly may be 
initiated from the system console or from control records previously placed 
into the system "COMMANDS" file. All general assembly options and file 
names are specified during initiation. 



The resulting binary, object program, file is produced in either QM/SYSTEM 
microcode format, if any DEF files were specified, or NOVA code format, if 
no DEF file was declared. NOVA object files are in a format equivalent to 
that required for loading on standard NOVA systems. QM/SYSTEM object files 
are provided in an internal format which is capable of being loaded into 
either of the 18 bit QM/SYSTEM memories, control store or main store. The 
object file formats are fully described in section 6.2 of this manual. 

Assembler operating procedures are described in detail in chapter 7. 
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2 LANGUAGE STRUCTURE 

This section discusses the rules for structuring source program statements- 
Statements are classified Into four types: comment* control* instruction* 
and data. Where applicable* statements are further subdivided Into fields* 
and these fields are themselves defined in terms of elements, 

2.1 STATEMENT CLASSIFICATION 

Statements are always contained within one source INPT file record. There 
Is no continuation of any statement on the succeeding record. Each new 
statement is classified by either the first character or first type 
of element recognized* when scanning the statement from left to right. 
The following subsections discuss the meaning of each statement type. 

2. 1. 1 COMMENTS 

A comment statement Is used to annotate the program listing. Any statement 
that has an asterisk (*.J or semicolon {;) in its first character position 
will be treated as a comment statement. It will be printed but will have 
no other effect on the program translation. 

A semicolon may appear tn any position on any statement, causing all char- 
acters to the right to be considered as comments for that statement. 
Should the first non-blank character on a statement be a semicolon then 
that statement is also considered a comment statement. The only except- 
ion to this rule is that semicolons may be used as character data where 
text strings are allowed. 

2.1.2 CONTROL (PSEUDO GPERAT IONS I 

MICRO maintains certain symbolic names in a special reserved name list* 
known as PSEUDO OPERATIONS. When a statement begins with a PSEUDO OPER- 
ATION name that statement is classified as a CONTROL statement. Each 
CONTROL statement has an immediate effect on MICRO* to control the 
current assembly. 

PSEUDO OPERATIONS way be used to control the source statement listing* 
conditionally determine whether object code should be generated, specify 
the microprogram location counter* or to generate text string data. 
PSEUDO OPERATIONS are discussed in detail in chapter 3. 

2.1.3 MACHINE INSTRUCTIONS (OPERATIONS} 

MICRO contains a predefined list of symbolic names that correspond to most 
of the machine operation codes of the "NOVA" computer architecture. This 
list may be completely replaced by a dynamically generated list from one 
or more micro-machine instruction set definition (DEF) files. Whenever 
a statement begins with a symbolic name that exists in this machine oper- 
ation code list that statement is classified as a MACHTNE INSTRUCTION. 
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Each operation code is provided with a set of format data which is used to 
determine how the assembler should further handle the processing of the 
statement. The final product of the processing of a MACHINE INSTRUCTION 
the generation of one or more object program words. 



fs 



2.1.4 DATA (CONSTANTS) 



When a statement does not meet the basic 
classifications described above f it will 
declaration statement. A DATA statement 
DATA declarations, separated by commas, 
one word 
since it 



qualifications for any of the 
be considered to be a DATA 
may contain several different 
Each DATA declaration will produce 
of object program data. The term "CONSTANTS" is included here 
is frequently used in other literature to refer to data generating 
statements. 



2.2 LEXICAL ANALYSIS 

Lexical analysis is the process by which an assembler locates symbolic 
entities on the source statement record. Each of these entities will be 
referred to below as an "element". In MICRO, the lexical analyser can 
recognize three types of elements: NAMES, OPERATORS, and NUMBERS. The 
standard ASCII character set is used by MICRO, though only a 64 character 
subset (see APPENDIX A* is recognized during lexical analysis. The 
following subsections define these elements. 

2.2.1 NAMES 

A NAME is defined as a letter or period (.J character alone, or followed 
by any number of letters, digits, or periods. Although a NAME may be any 
length, only the first 10 characters of each NAME are used to uniquely 
identify that NAME. It is the programmer's responsibility to avoid usina 
NAMES where only characters beyond the tenth position differ. Each NAME 
will take on further semantic meaning, depending on how it is used and 
what it represents. This will be discussed under STATEMENT PROCESSING, 
in section 2.3 below. 

Examples: Legal NAMES: 

A ABCDE00000 ANTI ENERGIST I C ... AND. SO. FORTH. . . 



I I legal NAMES: 
987 (actually a number> FCXJ (contains illegal characters> 
777SEVEN <a name cannot begin with a digit> 
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2.2.2 OPERATORS 

An OPERATOR is normally a single* special character (not a letter* digit* 
or period.) OPERATORS are used to delimit sets of elements (these sets 
are known as fields)* or to define relationships between elements (such as 
arithmetic operations.) The following is a list of OPERATORS and their 
meanings to MICRO. 

" " Any number of blank characters may delimit specific fields. 

! Exclamation point* represents trie logical operation "OR". 
£ Ampersand* represents the fog tea I operation "AND". 
+ Plus* used for arithmetic addition. 

Minus* used for arithmetic subtraction. 

* Asterisk* used for arithmetic multiplication. 
/ Slash* used for arithmetic division. 

* Comma* used to delimit fields within certain statements. 

* Semicolon* used to delimit the comment field of a statement. 

3 At sign* recognized during "NOVA" type assemblies (indirect)* 

* Pound sign* recognized during "NOVA" assemblies (suppress data). 

= Equal, classifies symbolic EQUATE statements. 
J Colon, identifies symbolic LABEL names. 

Period* special use to identify decimal valued NUMBERS. 

" Quotation mark* precedes character value constants. 

< Less than character* and... 

> Greater than character, delimit subfields in text strings. 

Any other special characters not listed above will be lexically marked as 
OPERATORS, but wtlf be Indicated as erroneous elsewhere in MICRO. 

2.2.3 NUMBERS 

A NUMBER consists of a string of one or more digits* through 9. NUMBERS 
may be subc I assi f led as DECIMAL (base 10) NUMBERS whenever the digit string 
is terminated by a period C.J. When delimited by any other character* the 
numeric value representation of a NUMBER is determined by the currently 
assigned radix (base) value. At the beginning of an assembly the initial 
radix value is 8, permitting all NUMBERS not followed by a period to be 
interpretted as octal values. NUMBERS are syntactically defined to legally 
consist of only those digits that are lower in value than the currently 
defined radix value. 

Examples * Legal NUMBERS: 

(Radix = 8 ) 32767. 32767 0010. I0I0I0 2 
(octal values! 077777 032767 000012 101010 000002 

(Radix = 2 ) 32767. 32767 0010. 101010 2 
(octal values) 077777 Ci I legal) 000012 000052 (illegal) 
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A numeric value representation of individual ASCII characters may be obtain- 
ed by preceding each character by a quotation mark ("> character. Thus the 
character pairs "A through "Z will produce the octal values 101 through 132, 
respectively. Refer to APPENDIX A for a complete list of ASCII character 
values. 

2.3 EXPRESSION EVALUATION 

An EXPRESSION Is defined to be a set of elements consisting of NAMES and 
NUMBERS separated by any of the recognizable arithmetic and logical 
OPERATORS. The purpose of an EXPRESSION is to provide a means of producing 
a single numeric value through reference to, and arithmetic operations 
upon, other values. 

When an EXPRESSION is processed, the elements are accessed in a left to 
right order. There are no hierarchaf attributes assigned to any OPERATORS. 
NUMBERS are converted to binary values according to the rules covered in 
section 2.2.3. NAMES are located tn the symbol table and their values are 
extracted. When a NAME is referenced it must be found in the symbol table, 
otherwise a diagnostic indication will be produced. 

Most EXPRESSIONS are processed only during assembly PASS 1. These EXPRES- 
SIONS may contain references to NAMES declared anywhere within the source 
program. Certain PSEUDO OPERATION statements are capable of processing 
EXPRESSIONS during PASS I. NAMES referenced by these statements must be 
specified in the source program preceding the reference. Specification of 
these NAMES may be accomplished through use of LABEL and EQUATE statements, 
discussed in sections 2.4.1 and 2.4*2 f respectively. The PSEUDO OPERATIONS 
that process EXPRESSIONS in PASS I are: .BLK first operand only (section 
3.4.1), .IFE (section 3.2.1), .IFN (section 3.2.2), .LOC tsection 3.4.2), 
.RDX (section 3.4.3) . 



2.3.1 EXPRESSION IN CONTEXT 

There are two types of context to be considered. First is the assembly 
Phase. During PASS 1, EXPRESSIONS will be processed only if they appear 
certain CONTROL statements, in appropriate fields. All EXPRESSIONS are 
evaluated during PASS 2, even those already processed in PASS 1. The 
results of those evaluated in both passes must match or an error conditi 
be indicated. The second context is the location of the EXPRESSION, 



on 



may 



. „ «,w, . . . >~ . w v*. v w <_ . ... u wwwwiii-j vsuiibc/xb io otic I \j u a u l U I I Ul blic l_/\ r i\LJJ i I 

in terms of the particular statement class and field position on that 
statement. 



An EXPRESSION field may contain any number of elements. It will be termin- 
ated upon occurrance of the delimiter OPERATORS: comma (,), semicolon (;)» 
and greater than (>), and also by end of record. The use of particular 
delimiters depends on the type of statement used. For example, the greater 
than delimiter is used only within text strings, where an EXPRESSION can be 
imbedded. Blanks may be used as NAME or NUMBER de I i m i te r s, but cannot 
terminate an EXPRESSION. 
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2.3.2 SUPPORTED OPERATIONS 

A total of six arithmetic and logical operations are supported by MICRO. 
The four arithmetic operations ares addition, subtraction* mu It f-p f icat ion , 
and division. Two logical operations are provided: logical sum (OR} and 
logical product (AND). All operations are performed in a strict left to 
right order. The following list shows the OPERATORS used to represent 
these operations. Each is followed by an example (octal radix is assumed.) 

+ ADDITION 

A + B + MORE + CONSTANTS + I + 2000. 

- SUBTRACTION 

- A * B - 100. + X - Y ; THE LEADING MAY BE OMITTED. 

* MULTIPLICATION 

5 * DATA * OFFSET * 1 

/ DIVISION 

WORDS / 2 + 1 

I LOGICAL SUM (OR? 

A * B / C ♦ 7 ! 40G000 t FORCE SIGN OF VALUE NEGATIVE. 

I LOGICAL PRODUCT (AND) 

LOCATION. A - LOCATION. B £ 400000 * EXTRACT ONLY THE RESULTING SIGN BIT. 

2.3.3 ARITHMETIC PRECISION 

MICRO maintains a full 18 bit value for each NAME and NUMBER processed. 
NUMBERS that have values greater than that which can be represented by an 
18 bit field will be truncated, modulo 262*144. During EXPRESSION evalua- 
tion ail overflow from multiplication* addition* or subtraction operations 
will be discarded* No indication of this form of truncation will be made. 
I I legal ' d i vi sion operations* such as dividing by zero* will usually produce 
a minus 1 result and no error indication. 
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2.4.1 LABELS 

LABEL statements consist of one or more LABEL NAMES. A LABEL NAME Is any 
legal NAME followed by a colon (:) character. Each of the LABELS appearing 
on the same record will be assigned the current numeric value of the micro- 
tocat ton-counter . Any other statement class may follow a LABEL statement 
within the same record, LABEL NAMES* thought may not be preceded by any 
other statement class on a record. 

LABELS declared ahead of statements that generate more than one word of 
object code wtll be assigned the I ocat ion-counter value of the first word 
generated by that record. LABELS are used to provide symbolic reference to 
instructions or data areas. 

Examples: LABEL statements: 

START: BEGIN: ENTRY: % ALL THREE LABELS WILL BE ASSIGNED THE SAME VALUE 
K1000: 1000. ; DATA CONSTANT VALUE 1000. IS NAMED KI000 
K2000: 2000. ? LABEL K2000 HAS A VALUE ONE GREATER THAN K1000 

2.4.2 SYMBOLIC EQUATES 

A statement beginning with a NAME followed by an equal sign {=) is classi- 
fied as an EQUATE statement. These statements provide the capability to 
assign values to LABELS other than the value of the current m icro-l ocat r on- 
counter. A LABEL NAME may be assigned a value only once within the same 
assembly. The value to be assigned is specified in the field following the 
equal sign. This field contains one EXPRESSION. EXPRESSIONS are described 
in section 2.3* above. 

Examples: EQUATE statements: 

ABC ^ 770. ? LABEL "ABC" REPRESENTS 770 DECIMAL 

CBS = ABC ■+ 990. / 2. ? LABEL "CBS" REPRESENTS 880 DECIMAL 

NBC = CBS - ABC * 6. J LABEL "NBC" REPRESENTS 660 DECIMAL 
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2.4.3 P5EUDO OPERATIONS 

When a statement begins with a NAME, and that NAME is in the PSEUDO OPER- 
ATIONS list, MICRO wiU perform some, immediate* special, action. Most of 
these actions function to control MICRO'S operation. Following recognition 
of the OPERATOR a CONTROL statement processor is entered to perform the 
specified action. LABELS may precede all statements In this class. An 
OPERATOR NAME must be followed by one or more blanks, a semicolon, or an 
end of record . 

Fields to the right of the PSEUDO OPERATOR NAME are handled differentfy by 
each CONTROL statement processor. Some require full arithmetic EXPRESSIONS 
to define the value to be used. Others utilize the field as a character 
string* disabling the normal lexical meaning of most characters. Comments 
may be included at the end of most CONTROL statement types, by preceeding 
them with a semicolon (;!. CONTROL statements are terminated only by the 
end of record being reached. 



Examples! CONTROL statements* 

.LQC . + 256. ; ADVANCE PROGRAM LOCATION 256 WORDS 

.TXT / CHARACTER STRING /? GENERATE ASCII TEXT DATA 
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2.4.4 INSTRUCTION PROCESSING 

When a statement begins with a NAME, and that NAME is in the OPERATION 
CODES list* MICRO will begin to generate a MACHINE INSTRUCTION. The 
action to be taken in the generation of each Instruction depends on which 
of the 16 microinstruction formats f or 8 NOVA instruction types, has been 
declared. MICRO locates the instruction format associated with the 
OPERATOR NAME, within the OPERATION CODES fist. The actual instruction 
format is passed to MICRO, from the DEF file, as a binary value. This 
value may be declared symbolically during a Nanoassembly . The table below 
indicates the binary format values, the symbolic NAMES available during 
Nanoassembl i es* and the actual format configuration. 




NAN0AS5EMBLY 
OCTAL DEFINITION 
CODE NAME 



20 


OP 


NULL 


21 


OP 


A.B 


22 


OP 


A.BR 


23 


OP 


AR.B 


24 


OP 


AR.BR 


25 


OP 


ABR 


26 


OP 


ABS 


27 


OP 


A 


30 


OP 


AR 


31 


OP 


B 


32 


OP 


BR 


33 










34 








35 
36 














37 
40 






OP 


A.B.V 


41 


OP 


ABR.V 


42 


OP 


ABS.V 


43 


OP 


ABCDE 


44 


OP 


ABC.DE 


45 
46 
47 















SOURCE 
STATEMENT 
FORMAT 

OP 7 

0P7 A5A,B6A 
0P7 A5A,B6R 
0P7 A5P,B6A 
0P7 A5P.B6R 
0P7 AB1IR 
0P7 AB11A 
0P7 ASA 
0P7 A5P 
OP7 B6A 
0P7 B6R 



KEY 

0P7 

A5 

B6 

AB11 

C6 

A6 

V18 



Bit Positions 



0P7 A5A,B6A,V18A 

0P7 AB11R,V18A 

0P7 AB1IA,V18A 

OP7 A5A,B6A,C6A,A6A,B6A 

0P7 A5A,B6A,C6A,AB11R 



XXX 
000 
000 
000 
XXX 
000 
XXX 



XXX 
000 
000 
000 
XXX 
000 
XXX 



xoo 
oxx 

000 

oxx 

000 
XXX 
XXX 



000 
XXX 
000 
XXX 
000 
XXX 
XXX 



000 
000 
XXX 
XXX 
000 
000 
XXX 



000 
000 
XXX 
XXX 

000 
000 
XXX 



A - Absolute Arithmetic Value 
R = Relative to Location Counter 
P = Positive Location Counter Rel. 



LABELS may precede all MACHINE INSTRUCTION statements. The OPERATION CODE 
NAME must be followed by one or more blanks, a semicolon, or an end of 
record. 
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2.4.5 DATA (CONSTANT) PROCESSING 

Once a DATA statement is recognized each field on the statement will gener- 
ate one word of data. Fields are separated by commas (»). EXPRESSION 
evaluation is performed on each field, and the resulting value is output 
in 18 bit format, LABELS may precede the first data field on the record. 
Comments may follow the fast data field, when preceeded by a semicolon (»). 



Examp les 



CONSTANTS 
VALUER: 



DATA statements 

1420 

1, 2, 3, 4 

CONSTANTS + 1 



; SINGLE DATA WORD 

t FOUR DATA WORDS, LABEL REFERS TO THE 1 

? CONTAINS LOCATION OF CONSTANT VALUE 2 
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MICRO does not support nesting of conditional tests. Any . I FE or .IFN 
statements encountered while in non-assembly state will be ignored. It is 
permissible to place several tests preceding one .ENDC statement* any one 
of which may enter non-assembly state. 

3.2.1 .IFE - ASSEMBLE IF EXPRESSION IS EQUAL TO ZERO 

.IFE <EXPRESSION> ? (COMMENTS) 

If the result of the EXPRESSION is zero all source statements following 
this statement will continue to be assembled. If the result is any non- 
zero value then source statements will be skipped (and listed if listing 
is enabled) untlf an end of conditional assembly statement is encountered. 
An omitted OPERAND field will be recognized as an error. 

Examp I es^ 

.IFE 1 J FORCED SKIP CONDITION. 

.IFE SECOND - FIRST - 2 ; ASSEMBLE IF SECOND = FIRST + 2. 

.IFE EVALUED I 400000 ? ASSEMBLE IF "EVALUED" IS POSITIVE. 

3.2.2 .IFN - ASSEMBLE IF EXPRESSION IS NON-ZERO 

.IFN <EXPRESSION> J (COMMENTS) 

.IFN is the inverse function to .IFE f above. Source statements following 
an .IFN statement wilt continue to be assembled if the result of the 
EXPRESSION is non-zero.. When the result is zero then source statements 
will be skippedt and listed if listing is enabled* until an end of condit- 
ional assembly statement is encountered. An omitted OPERAND field will be 
recognized as an error. 



; FORCED SKIP CONDITION. 

; ASSEMBLE IF BITS OR 2 ARE PRESENT. 

; ASSEMBLE IF "EVALUED" IS NEGATIVE. 



Examp 1 est 




.IFN 





.IFN 


OPTIONS I 5 


.IFN 


EVALUED I 400000 
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3.2.3 -ENDC - END CONDITIONAL ASSEMBLY 

• ENDC i (COMMENTS! 

The .ENDC statement simply reinstates normal source statement assembly, 
whenever the non-assembly state is in effect. Otherwise, it has no effect. 

Examples 

•IFN. A-B L 400000 ; IF "A" < "B", GENERATE AN ERROR 
(ERROR "A" LESS THAN "B"I : MESSAGE FROM "MICRO" VIA UNKNOWN 
•ENDC ; STATEMENT TYPE. 

3.3 LISTING CONTROL 

Three PSEUDO OPERATIONS are provided for control of the source program 
listing: EJECT, LISTOFF, and LISTON. These statements will ignore their 
OPERAND fields. Listing selection may be controlled conditionally, using 
the CONDITIONAL PSEUDO OPERATIONS described in section 3.2. The EJECT 
statement will be recognized uncond i t iona I I y * in order to permit uniform 
listing appearance while in non-assembly mode. When the full listing is 
suppressed, and only lines in error are to be displayed, the function of 
EJECT is also suppressed. Erroneous lines will be displayed no matter what 
listing selections have been made. Only a SUPPRESS ALL LISTABLE OUTPUT 
option, specified during assembly Invocation (see section 7.31, will sup- 
press lines in error. 

3.3.1 EJECT - END OF PAGE (FORMS) 

EJECT ; (COMMENTS! 

The EJECT statement will set an indicator, in MICRO, to fist the next line 
of ((stable output on a new page. This statement will have no effect when 
the listing is being displayed on the alternate list device, normally the 
system console, as specified by a SELECT ALTERNATE DEVICE option during 
assembly invocation. It will also be ignored when it follows a LISTOFF 
statement, described in section 3.3.2 below. 

Examples 

EJECT t END OF THIS PAGE .» 
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3.3.2 LISTOFF - TURN LISTING OFF 

LISTOFF ; (COMMENTS) 

The LISTOFF statement wHl suppress listing of all following statements, 
until a LISTON statement (section 3.3.3) is encountered. Any EJECT state- 
ments located between a LISTOFF - LISTON statement set will be suppressed. 

Examples 

LISTOFF f NO LISTING FOR A WHILE. 



3.3.3 LISTON - TURN LISTING ON 

LISTON ? (COMMENTS) 

The LISTON statement restores listing of all following source statements, 
and recognition of EJECT statements. LISTON will always be listed. It 
wifl have no effect if encountered when listing is already enabled. 

Examp le t 

.IFE LIST-I ; ASSEMBLE NEXT STATEMENT IF LIST = I. 

LISTOFF J LISTING SUPPRESS OPTION IS SELECTED. 

.ENDC J END CONDITIONAL SECTION. 

/ .........\ » 

/...... .........\ THESE STATEMENTS, AS WELL AS THE .ENDC 

\...... .*../ ABOVE, ARE CONDITIONALLY LISTED. 

\ ......./ 

LISTON J RESTORE LISTING AT THIS POINT. 

3.4 ASSEMBLY CONTROL 

The following six PSEUDO OPERATIONS provide general control over the opera- 
tion of MICRO. The three statementsJ .BLK, .TXTM, and .TXT, provide for 
the generation of multiple word data arrays. The remaining three state— 
mentss -LOC* .RDX, and .XPNG, provide control over source program interpre- 
tation and symbol table content. 

3.4.1 *BLK - BLOCK DATA GENERATION 

.BLK <EXPRESSION>( ,<EXPR ESS I0N> ) ; (COMMENTS) 

The first OPERAND field of the .BLK statement is required, and specifies 
the number of words to be occupied by this data array. If the, optional, 
second field is specified then the resulting 18 bit value will be used to 
fill all locations of the data array. Otherwise, no data wifl be generated 
and only the micro-location-counter will be adjusted to reflect the space 
required. The first OPERAND field is evaluated during PASS I, and there- 
fore may only reference LABELS defined ahead of the .BLK statement. The 
second OPERAND field is evaluated during PASS 2, and may reference any 
properly defined LABELS. 
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Examp I es: 

CARDS: .BLK 80. /2 

TABLE: -BLK TABSIZE,-! 

SYMBOL: .BLK 1000. *8. 



; ALLOCATE 80 CHARACTER DATA BUFFER. 
? GENERATE TABLE, INITIALIZED TO -1'S 
t DEFINE SYMBOL TABLE ARRAY, 1000 X 8 



3.4.2 .LDC - LOCATION COUNTER DEFINITION 



.LOC 



<EXPRES5IDN> 



C COMMENTS) 



Normally the mic ro-l ocat ion-counter Is updated following the processing of 
each statement capable of generating object code or data. Standard MACHINE 
INSTRUCTIONS will occupy one or two words of storage, and will Increment 
the micro-location-counter appropriately. Other PSEUDO OPERATIONS wit! 
produce variable amounts of object data, also incrementing the location- 
counter. When it is desired to place the location-counter at some address 
that is not a representation of generated object storage the .LOC PSEUDO 
OPERATION may be used. The result of the EXPRESSION evaluation will be 
placed directly into the mic ro-t ocat ion-counter . The EXPRESSION is pro- 
cessed during assembly PASS l r and may reference only those LABELS defined 
preceding the -LOC statement. 

.LOC may be used at the beginning of the program to set the initial start 
of program address. Later on it may be used to allocate space, similar to 
the .BLK statement (section 3.4.11, through use of an EXPRESSION adding a 
constant to the current m i cr o~l ocat Ton-count er . The current micro-location- 
counter is accessible at any time by reference to the special LABEL ".". 



Examp I es: 

.LOC 
CARDS: .LOC 



256. 
80./2 *+. 



PRESENT :.LGC .-SOMETHING 
BACK: SOME. DAT A 

.LOC PRESENT 



? BEGIN PROGRAM AT LOCATION 256. 

? DEFINE 80 CHARACTER DATA BUFFER. 

? IDENTIFY "PRESENT" LOCATION, THEN GO 

; BACK TO INSERT SOME DATA, AND FINALLY 
? COME BACK TO THE "PRESENT". 



3.4.3 .RDX - NUMBER BASE DEFINITION 



RDX 



<DECIMAL EXPRESSION> 



(COMMENTS 1 



NUMBERS are initially decoded as octal value- representations! unless the 
NUMBER is terminated by a period (.) which represents decimal value. The 
numeric base, or radix, which MICRO uses to decode NUMBERS is itself varia- 
ble, and may be changed at any time through the .RDX PSEUDO OPERATION. The 
OPERAND field, is represented by a DECIMAL EXPRESSION, which means that 
within this field all NUMBERS will be decoded as having decimal values. 
This EXPRESSION is processed during PASS 1, and should reference only pre- 
defined LABELS. Any radix value between and 10 will be considered legal 
by MICRO. 
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Examp I est 



RDX 10 
RDX 2 
RDX 8 



r ALL NUMBERS WILL BE DECIMAL. 

J ALLOW GENERATION OF BINARY BIT VALUES 

J RESTORE OCTAL NOTATION. 



3.4.4 .TXTK - SET TEXT MODE 



.TXTM 



<EXPRESSION> 



f COMMENTS J 



Text, or character string, data may be generated by any of the text PSEUDO 
OPERATIONS discussed in section 3.4.5* below. All text generated by MICRO 
is produced in 7-bit ASCII, as shown rn APPENDIX A, CHARACTER SET. This 
text data wilt be packed, two characters to a word* using the rightmost 
16 bits as two 8 bit character fields. The default ordering of characters 
within a word is right to left. The first character is placed into bit 
positions 7 to 0, and the second is placed into positions 15 to 8. When it 
is desired to generate characters within each word in a left to right order 
.TXTM must be used. Any non-zero EXPRESSION result will indicate left to 
right ordering, while zero will produce the default right to left order. 



Examp less 



.TXTM 1 
.TXTM 



; TEXT WILL BE LEFT TO RIGHT. 
: TEXT WILL BE RIGHT TO LEFT. 



3.4.5 



TXT - GENERATE TEXT STRING DATA 



TXT 
TXTO 
TXTE 
TXTF 



$<STRING£<EXPRESSION»$ 



(COMMENTS)— ZERO PARITY 
—ODD PARITY 
— EVEN PARITY 
— ONE PARITY 



Character string, text, data may be generated through use of any of the 
•TXT PSEUDO OPERATIONS shown above. Text is generated in 8 bit character 
fields, placed two to a word, within bit positions 15 through 0. MICRO 
will produce characters in 7 bit ASCU format? see APPENDIX A, CHARACTER 
SET. Character string object data will always be terminated by at least 
one 8 bit zero character. If a string contains an odd number of characters 
then the last character of the last word will be zero. If an even number 
of characters are defined then MICRO will, automatically, generate an extra 
word of zeroes after the string. 

The first non-blank character following the PSEUDO OPERATION NAME will be 
recognized as the string delimiter, as represented by the dollar sign ($) 
above. The second encounter of this character will terminate the character 
string. The delimiters will not be included in the generated string data. 
A comment field may follow this terminator. When it is desired to include 
characters that are not in the ASCII character subset, or to include the 
string delimiter character itself, a numeric EXPRESSION may be imbedded 
within the string to accomplish this. Each EXPRESSION field is preceded by 
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a less-than character C<J, and is terminated by a greater-than character 
{>). The result of the EXPRESSION will be truncated to 8 bits, and wilt be 
placed within one object character field. A character constant, a quota- 
tion mark CM preceding any character, may then be used to represent the 
delimiter character. Symbolic representations may then be used for the 
special codes needed* such as carriage returns or communications control 
codes 




MESSAGE:. TXT /LAST LINE RECEIVED WAS IN ERROR!/ 

* GENERATE 80 CHARACTERS OF ASCENDING NUMERIC ORDER. 

ALIGN: .TXT 10123456789 1Z3456789 123456789 1234567891 ? FIRST 40... 

.LOC .-1 ; BACK UP OVER THE GENERATED ZERO WORD. 

.TXT ! 123456789 123456789 123456789 123456789! I SECOND 40... 

CARRIAGE. RETURN =15 f RETURN TO BEGINNING OF LINE. 

LINE. FEED = 12 ; SPACE DNE LINE VERTICAL. 

•TXTH 1 ; LEFT TO RIGHT FDR CONSOLE MESSAGE. 

HELP: .TXTO * <CARR I AGE .RETURNXLINE .FEED>*** PLEASE CHANGE PAPER' 

t 

DEMAND: .TXT /<15X12>RESP0ND AFTER THE "<"/>•' CHARACTER <15><12><"/>/ 

* PRODUCES THE FOLLOWING OBJECT STRING (OCTAL}: 

* 015 012, 122 105, 123 120, 117 116, 104 040, 101 106, 124 105, 

* 122 040, 124 110, 105 040, 047 057, 047 040, 103 110, 101 122, 

* 10* 103, 124 105, 122 040, 015 012, 057 000. 

3.4.6 .XRNG - DELETE PREDEFINED SYMBOLS 

♦XPNG j tCQMMENTS) 

During assembly PASS 1, the .XPNG statement will delete all LABEL NAMES and 
MACHINE INSTRUCTION definitions from the assembler symbol table. PSEUDQ 
OPERATION NAMES are not disturbed. .XPNG is provided for compatibility 
with NOVA type assemblers. Following its use there are no instruction 
OPERATION CODE NAMES available, and only DATA statements can be processed. 

This statement is meant to be used only at the beginning of an assembly, 
and would be followed by symbolic MACHINE INSTRUCTION operation code, and 
format, definitions. Symbolic definition is not available in this version 
of the MICRO Assembler. 
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4 INSTRUCTION SETS 

Any number of instruction sets may be processed by MICRO* When invoked, 
the assembler contains a predefined instruction set for the NOVA type 
system architecture. This is provided in order to support NCS, the system 
which supports QM/SYSTEM assemblers and data file management. Other micro- 
instruction sets are defined through DEFINITION files, prepared during 
Nanoassembl i es. Actual, detailed, discussions of DEFINITION file and 
microinstruction set development are available in the QM NANOASSEMBLER 
REFERENCE MANUAL. 

This chapter briefly discusses the rules for utilizing the various instruc- 
tion sets. The access to DEFINITION files is also covered. 

4.1 PREDEFINED "NOVA" INSTRUCTION SET 

In MICRO* the NOVA instruction set consists of 182 MACHINE INSTRUCTION def- 
initions. Most of these are identical to the NOVA instruction set provided 
by standard NOVA assemblers. User*s should be fully familiar with the NOVA 
architecture before using this instruction set. 

Several special definitions are provided for the support of NCS, and for 
ease of utilization of the arithmetic comparison instructions. Only these 
special definitions are listed below. 

4.1.1 MACHINE INSTRUCTIONS 

NOVA operations are provided for the NOVA 1200, and NOVA 800 machine ser- 
ies. The QM/SYSTEM NOVA emulation provides all capab i I i t i es , including 
support for the Hardware Multiply/Divide option. Input/output devices are 
driven according to actual hardware device specifications. See the NCS 
OPERATIONS GUIDE for further details. The table below lists those prede- 
fined OPERATION CODE NAMES which are provided for NCS support. 

Conditional and unconditional skip/no-skip instructions: 

NOP NO-OPERATION CACTUALLY A M0V# 0,0 J 

SEQ A r B SKIP NEXT INSTRUCTION IF A .EG. B 

.EG. A,B 



»• H 



SGE ArB SKIP NEXT INSTRUCTION IF A .GE. B 

.GE. A r B " " " " " 

SKIP NEXT INSTRUCTION IF A .GT. B 

it ii m ii ti 

SKIP NEXT INSTRUCTION IF A -LE. B 

rt ii it ti it 



SGT 


A,B 


.GT. 


A»B 


SLE 


A,B 


.LE. 


A,B 
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SLT A,B SKIP NEXT INSTRUCTION IF A .LT. B 

. L T • A 9 B .1 it m •• « 

SHE A,B SKIP NEXT INSTRUCTION IF A .NE. B 

. N E . A , B mm m •• M 

Abbreviations used in the above list are: 

.EQ. EQUAL TO 

.GE. GREATER THAN OR EQUAL TO 

.GT. GREATER THAN 

.LE. LESS THAN OR EQUAL TO 

•LT. LESS THAN 

.NE. NOT EQUAL TO 

4.1.2 STATEMENT FORMATS 

Alt NOVA instructions are one word in length. There can be from zero to 
three OPERAND fields per instruction. In several instruction formats f one 
or more, fields may be optional. The default value for optional fields is 
zero. Use of the special OPERATORS for indirect addressing (at-sign, 21, 
and suppress data transfer {pound-signt #1 are restricted as follows. 

The indirect address form of DATA statement requires that the at-sign be 
placed at the beginning of the first element of the DATA DEFINITION field. 
This will result in presetting an initial OPERAND value of 100000 (octal), 
which represents setting the indirect address bit of the NOVA data word. 
This method of address generation restricts the remainder of the EXPRESSION 
to consist only of addition and subtraction operations* none of which may 
cause field overflow. If multiplication or division is required in an 
indirect address definition the at-sign should not be used, and a constant 
value of 1 00 000 should be log i ca I I y added at the end of the EXPRESSION. 

Examp less 

SDATARRAY + 1 JteBRHAL APPEARANCE OF INDIRECT ADDRESS. 

DATUM * 4 + BASE ! 100000 J ALTERNATE INDIRECT ADDRESS FORMAT. 

Indirect address reference from an instruction OPERAND field also requires 
that the at-sign be placed Just: ahead of the first element of the address 
field. Placement of the indirect OPERATOR at some other point will cause 
the address EXPRESSION to evaluate incorrectly. 

Examp less 

LDA 0,3STACK J LOAD DATA FROM ADDRESS AT "STACK". 

STA 2,24,3 ; STORE DATA AT THE ADDRESS FOUND AT 

? THE LOCATION DEFINED BY THE CONTENTS 
J OF ACCUMULAT0RC3) + 4. 

JMP 3RETURN ; TRANSFER TO THE ADDRESS IN MEMORY 

; LOCATION "RETURN". 
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The suppress data transfer OPERATOR may be appended to any of the logical 
or arithmetic! register to register. Instruction OPERATION CODE NAMES. 
The pound-sign character wilt indicate an error if used elsewhere on an 
instruction statement. 

Examp I es: 

M0V# 1,1, SZR ; SKIP IF ACCUMULATOR I IS ZERO. 

5UB0# 1,2,SNZ ; SKIP IF AC 1 IS NOT EQUAL TO AC 2. 

4.2 EXTERNALLY DEFINED MICROINSTRUCTION SETS 

A single instruction DEFINITION file CDEFI usually contains the complete 
structural definition of a microinstruction set. When two, or more, micro- 
instruction sets are to be used concurrently all must be declared as DEF 
files during assembly invocation. Microinstructions are implemented as 
nanop rogr ams within the DEF file. Each nanoprogram will be loaded at an 
absolute location in Nanostore, and therefore has an absolute address value 
which becomes the OPERATION CODE value. When multiple microinstruction 
sets are used they must be allocated to unique addresses within Nanostore. 
Specification of DEF files is covered in chapter 7, OPERATING PROCEDURE. 

4.2.1 MACHINE INSTRUCTIONS 

As an example, the "MULTI" Micromachine is used as a common microprogram- 
ming base for many emulations, user processes, and for the "TASK" micro- 
programmed OPERATING SYSTEM (see section 5.2). -MULTI" is fully described 
in the "MULTI MICROMACHINE DESCRIPTION" Manual. It consists of 78 micro- 
instructions, which are similar in appearance to conventional machine 
instruction sets. Combining "MULTI" with a specialized microinstruction 
set for a particular process will produce an efficiently operating program, 
which may be quickly implemented. 

4.2.2 STATEMENT FORMATS 

The formats for microinstruction generation are discussed in section 2.4.4, 
above. Ail OPERAND fields defined for a specific instruction must be spec- 
ified on the MACHINE INSTRUCTION statement. Null fields are permitted, and 
will produce zero results. There are two classes of fields processed by 
MICRO* absolute value, and location-counter relative. The contents of an 
absolute value field may be positive or negative, as long as the two's 
complement positive value will fit within the field width* Locat i on -count- 
er relative fields may be either one way, forward or reverse reference, or 
two way, where positive means forward reference and negative means reverse. 
One way relative fields always contain absolute values, while the signed 
relative fields may contain two's complement values. Values placed into 
location-counter relative fields must reference program addresses where the 
displacement value is small enough to fit within the field width provided. 
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Field width is defined by the specific field attribute identification, 
which also specifies field location within the instruction word being 
defined. Only those field structures are supported that correspond to the 
QM/SYSTEM microprogramming a r ch i tectur e, as defined in the "HARDWARE LEVEL 
USER'S MANUAL". These field formats are also depicted in section 2.4.4, 
above. In this version of MICRO the m i cro- f ocat i on-counter value always 
points to the word being generated. Therefore, when the location-counter 
is referenced within a 36 bit wide instruction (through LABEL NAME "."J, it 
will point to the first word of the instruction only when used in fields 
defining that word, and will contain the second word address when refer- 
enced in f ie I ds def i n ing the second word. 



4.3 DEFINITION FILES 




Disk space allocations for DEFINITION files can be approximated by multi- 
plying the number of symbols by 10 words, and then dividing by 256 words 
to determine the number of sectors needed. When the file also contains 
object Nanocode its size will grow substantially, requiring four 16 bit 
words per Nano-p r I mi 1 1 ve field defined. There is no simple way of predic- 
ting file size in this case. Section 6.3 further describes the physical 
organization of the DEFINITION file. 
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5" PROGRAM STRUCTURE 

This chapter discusses the organization of programs f and the interfacing of 
these programs to the various fevels of Operating Systems provided with the 
QM/SYSTEM. 

5.1 ABSOLUTE PROGRAMS 

MICRO produces object programs in absolute format. This means that the 
data structures placed onto the BIN file wilt be loaded and executed En an 
unaltered fashion. Each source program must contain an initial location- 
counter declaration (.LOCJ f to define its operating storage load point. 
If no initial location is defined the program will be assembled to load at 
I ocat ion 0. 

5.1. I MICROPROGRAMMING CONSTRUCTS 

There are two methods of executing m i cropr og rams r as stand-alone, fully 
self-contained, microprograms* or as tasks operating under control of the 
"TASK" OPERATING SYSTEM. When run in stand-alone format, programs may be 
loaded directly from their BTN object fifes» through the "QMLD" micropro- 
gram loader, or from the N2022 Cartridge Tape 5ystem f as prepared using 
the "PREP" Cartridge Tape writing system (these are described in the "NCS 
OPERATIONS GUIDE". ) 

If the Nanoprogram System utilized by the microprogram being run permits 
initial program entry via direct transfer to a Nanostore location, then no 
special add i t i ona I p r eparat i ons are of concern to the mi croprogramme r . All 
QM/SYSTEMS contain a Read-Only-Memory, used in starting machine operation. 
This memory contains an instruction called MICROSTART, which may be called 
on to preset all QM/SYSTEM Local Store, External Store, and F Store regis- 
ters to values placed within a 64 (decimal) word Control Store array. This 
MICROSTART array is organized as follows: 
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00 I LOCAL STORE REGISTERS I 
/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\ 

35 I THROUGH 35 (OCTAL J I 
I ~ j 

36 I EXTERNAL STORE REGISTERS I READ-ONLY-MEMORY: 

65 I 10 THROUGH 37 ( OCTAL ) I 

I r MICROS TART 

66 I FKIX FMOD FACT I 
r _„ ^ r 

67 I FSID FSOD FUSR I ARRAY 

70 I FCIA FCID FCDD I 

71 I FAIL FAIR FAOD I 

72 I FETD FEOD FEIA I 
I j 

73 I FEOA FMPC FIDX I 

74 I GO GI G2 I 

75 I G3 G4 G5 I 

76 I G6 G7 G8 I 
"77 I G9 GIO Gil I 

When starting any microprograst several of these registers must be defined. 
All undefined rag i st ers shouJ d be set to zero. The following information 
must be provided for a valid microprogram starts 

FMPC Must indicate the Local Store register number to be used as the 
initial M icro~Program-Counter» 30, 31, 32, or 33 (octal). 

FIDX Must contain the appropriate Nanostore page number, for proper 

m Ic.ro Instruct Ton OPERATION CODE decoding (bits 2 - 01. FIDX also 
contains the ALU width. System Supervisor State, and Read-On I y- 
Nanostore access controls. Refer to the "HARDWARE LEVEL USER'S 
MANUAL" for further details* 

F*** Any other F Registers, as required by the Nanosystem conventions 
in use. (ie: FCOD and FAIR may need to be preset to 31.) 

R(FMPC) Local Store Register specified in FMPC, as the initial Micro- 
Program-Counter. This register contains the address of the first 
microinstruction to be executed. 

A MICROSTART Array may be placed anywhere within the microprogram. It 
should be placed on a 100 (octal) word boundary, to permit direct system 
program entry via QM/CPU F-Switch selection (see "NCS OPERATIONS GU I DE". ) 
A version of the MICROSTART Array Is utilized when starting a primary task 
under the "TASK" System. 
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5.1.2 "NOVA" PROGRAMMING CONSTRUCTS 

NCS executes NOVA programs at the Main Store level of the GM/5YSTEM. The 
object program loader "LD" may be invoked by entering the command: 

! LD f f rl enamef-negd l sp lacementj « 

Where "filename" identifies the BIN file containing the object program. 
The optional "-negdi sp lacement" parameter is provided for NCS System Trans- 
ient program support. It subtracts the octal value "negd i sp I acement " from 
all object program load addresses* placing the program lower in storage 
than the assembled toad point. 

NCS has no low storage requirements. Therefore, user programs may utilize 
locations through the base of the NCS resident control program at 17077 
(octal). The Resident occupies 17100 to 17777, making locations 20000 
through the end of accessible storage available to user programs. Section 
5.3, below* fists the NCS facilities provided for utfiization of supported 
input/output drivers and program loaders. 

5.2 "TASK" SYSTEM INTERFACE 

For a microprogram to run under "TASK" it must first be placed into the 
active Task User Library. These libraries are usually resident in Main 
Store, in an area only accessible to the system. When in operation, 
microprograms may be broken up into SEGMENTS. These SEGMENTS may then be 
run sequentially as overlays to each other, or concurrently at different 
TASK Priority Levels. "TASK" operation is described in the "TASK CONTROL 
PROGRAM OVERVIEW" manual. 

Alt facilities provided by TASK are accessed through the "SYSTEM" microin- 
struction, of the "MULTI" M i c romach ine , described below. 

5.2.1 MEMORY ORGANIZATION 

Under basic versions of "TASK" the Task Control Program, Control Store res- 
ident, occupies the highest region of available Control Store. All storage 
below this region is available to user programs, system processors, or com- 
binations of user and system programs. The predefined NAME "TASK. BASE" 
passes the actual base address of the Resident to each microprogram assem- 
bly. This NAME is defined within the "MULTI" microinstruction set DEFINI- 
TION file. 

Frequently, the active microprogram wilt utilize the console display and 
control functions of "PROD", the Programmable Run-time Operator Dispjay 
program. PROD occupies the Control Store region immediately below TASK. 
When active, PROD executes as the highest priority Task. The primary pur- 
pose of PROD is control over the user microprogram, with a highly flexible 
debug and analysis capability. PROD is described in the "PROD USER'S 
GUIDE". 
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Main Store contains the TASK System and User SEGMENT overlay libraries. 
These libraries occupy the lowest region of physical Main Store. Every 
individual Task has access to its own region of storage, controlled by TASK 
and the Base / Fiefd Length hardware feature of the QM/SYSTEM Central Pro- 
cessor. When necessary, user storage regions may overlap each other, or be 
fully contained within another region. This permits environments, such as 
an emulator, to have Tasks and Subtasks with hierarchal storage access 
privileges as well as the usual CPU access priorities. For example, the 
inner Task region may be the actual emulator, while the next outer Task may 
be an I/O device emuiator which needs access to both its own working stor- 
age and the emulated storage space, 

5.2.2 "SYSTEM" INSTRUCTION CALLS 

To the "MULT!" microinstruction set the "SYSTEM" instruction is simply a 
programmed Interrupt, received by the TASK Control Program. The OPERAND 
field is passed to TASK, which will interpret the parameter value as a 
specific function call. The following list describes several of the func- 
tions supported by TASK. A more complete explanation will be found in the 
"TASK CONTROL PROGRAM OVERVI EW" manua f . 



NAME 



OCTAL 
CODE 



FUNCT ION 



SYS.RCL+S 



00 



Terminates the current Task, passing the STOP CODE 
value "S" CO to 151 to the Parent Task. 



SYS. SID 



SYS. WAIT 



20 



40 



Start I/O operation. An I/O Control Block must be 
be identified through a Local Store register. 

Wait, and remove Task from access to the Central 
Processor f until the EVENT, identified by an Event 
Control Word, has occurred. 



SYS.WAITL 



41 



Walt, and remove Task from access to the Central 
Processor, until one of the EVENTS, identified by 
a list of Event Control Word addresses pointed to 
by a Local Store register, has occurred. 



SYS. TIME 
SY5.ITASK 



47 

50 



Read the DATE and TIME registers, to Loeaf Store. 

Initialize a Subtask's registers, and prepare it 
for execution. 



SYS.STASK 

SYS.KTASK 
SYS.SMSB 
SYS. LOAD 



51 

52 
55 

60 



Enable a Task for access to the Central Processor, 
as soon as it attains highest Task priority. 

Disable a Task from any further execution. 

Offset Main Store base address within allocation. 

Load an overlay SEGMENT, into Control Store, as 
identified by a Load Control Block pointed to 
through a Locaf Store register. 
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5.3 "NCS" SYSTEM INTERFACE 
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ry ov 
basic 
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basic operating environment originally developed for smaller mem- 
ter Installations. Version I of NCS was developed for use with a 
OVA architecture computer, using standard and specialized I/O 
I equipment. The primary Intent of NCS was to support data and 
ifes In a small disk storage environmentt with absolute minimal 
erhead. Version 1 requires a nominal 700 (octal J locations for 

resident control programs t and 2000 (octal} locations in order to 
ser program and initiate its execution. This represents a program 
n overhead of 12.5*? and a dynamic memory availability of better 
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The permanently resident segment of NCS occupies 700 (octal) locations of 
NOVA memory. Figure 5.3.B shows the layout of NCS Resident, using an 8K 
configuration for address examples. The left column of numbers indicates 
the base of each coded section. The rightmost cofumn indicates the dis- 
placement of each section from the assembly language symbol "TOP" (which 
represents actual core size}. 

5.3.1 MEMORY ORGANIZATION 

Locations T0P-1 through T0P-3 are jump instructions into primary NCS func- 
tions. Transfer is made to T0P-1 (EOJJ whenever a user program, or oper- 
ator console task, wishes to terminate operation. E0J calls on the super- 
visor control program, which places both CRT Console and TTY into command 
state. This location is also set into the NOVA console switches when first 
starting up the system (location 17777 in the 8K version}. 



Initiation of most system tasks is accomplished through transfer to T0P-2 
(LDRI, which unconditionally fetches a system transient sector. The call- 
ing sequence for LDR action is described in section 1.3. T0P-3 (LDRX1 is 
used only during internal calls made by transients. LDRX calling sequence 
differs from the LDR sequence, in that part of the preceeding LDR call 
remains residual ly active during the LDRX activity. T0P-4 (RECURl is norm- 
ally used during an LDRX activity and provides the name of the originating 
task, which is to be recalled at completion of the current task. 



GM MICROASSEMBLER REFERENCE MANUAL NANODATA CORPORATION Ed.l Page 0035 

During LDR operation accesses are made to disk directories! established in 
cylinder of each disk. To permit some internal system tasks to use the 
existing LDR disk accessing routines for their own disk I/O, a pointer to 
the LDR disk command array is maintained at TOP-205. Only internal tasks 
should modify this array. General control over LDR actions is supported 
through a "MODE" control word, at location TOP-206. At normal job start 
"MODE" is automatically set to 0* The setting of "MODE" to non-zero will 
cause LDR to bypass any standard relocation of transients from the trans- 
ient buffer area. It also suppresses execution of executable (Type II 
transients. It is the responsibility of the program in operation to reset 
"MODE" to 0. EQJ will also clear "MODE". 

Operator console communication is mat nta i ned Copt i ona I I y } through the "GETC" 
and "PUTC" routines within the resident. "PUTC" will transmit one ASCII 
character to the currently active console. Transfer to "PUTC" is through 
location TOP-207 • "GETC" reads one character from any active console. It 
is entered by transfer to TOP-210. 

Below NCS Resident at location 17100 -(octal! are the standard disk inter- 
face routines* Entry is made at locations TGP-677 or T0P-700. Locations 
T0P-740 through T0P—70I are used for general program/system communication, 
and for inter-transient communication. The most frequent use for this area 
is for File Control Block (FCB) tables. An FCB is set up for each open 
disk file, during program execution. Each FCB identifies the current posi- 
tion, extent, buffer location, buffer content and file type for the active 
file. 



_ . y 

1 

TYP. EU1TRANSIENT r 

r 
/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\i 

r 
i 
i 
i 
i 
i 
i 
i 
i 
i 

LOAD POINT (ABS. ADDRESS} I 

ENTRY POINT (ABS. ADDRESS) I 
„ > 



Executable code area, from 
locations 2 through 377. 



< ,_„ > 

I I 

ITYPE(2)TRANSIENT I 

I I 

I Executable code area, from I 
I locations M through 377. I 
I I 

I/\/\/V/\/\/\/\/\/\/\/\/\/\/\/\/\I 

F/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\L 
I I 

I ENTRY POINT, SUBROUTINE N+M I 

T i» tt n T 

i * • » I 

I " " " N+l I 

I M " K I 

I PACKET LENGTH FROM THIS LOC . I 

I LOAD POINT (OPTIONAL J I 

I 000000 (NO ENTRY) I 

< y 



FIGURE 5.3.AA 



FIGURE 5.3.AB 



FIGURE 5.3. A 
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EXAMPLE OF 8K MEMORY SYSTEM (NCS RESIDENT STRUCTURE] 



20000 
17777 
17776 
17775 
17774 



17770 



17573 
17572 
17571 
17570 



17100 



17040 



16440 



(EOJi END 

(LDR) TRA 

(LDRXI INT 

(RECUR) INT 

BOOT LOADE 
ENTRY POIN 

NCS RES 

1. END OF 

2. TRANSI 

3. CQNSOL 

(INTERNAL} 
(MODE! 
(PUTC J 
CGETC1 



OF JOB 
NSIENT L 
ERNAL TR 
ERNAL CA 
/\/V/\/\ 
R ROUTIN 
T € o p t j o 
/\/\/\/\ 
1DENT MO 

JOB (Ma 
ENT LOAD 
E COMMUN 
/\/\/\/\ 
LOADER D 
LDR MODE 
TRANSMIT 
READ CHA 



ENTRY V 
OADER E 
ANSIENT 
LL RECU 
/\/\/\/ 
E ENTRY 
nal 1 
/\/\/\/ 
NITOR C 
chine S 
ER. 

ICATION 
/\/\/\/ 
I5K COM 
CONTRO 
CHARAC 
RACTER 



ECTOR 
NTRY VECT 
TASK CAL 
RSION REG 
\/\/\/\/\ 
, STANDAR 

\/\A/\/\ 

ONTAINSS 
tartl CON 

INTERFAC 
\/\/\/\/\ 
MAND ARRA 
L SWITCH 
TER TO CO 
FROM CONS 



OR 

L VECTOR 

ISTER 

D MACHINE START-UP 
TROL 



Y ADDRESS 

(NON-ZERO = NO-EXEC. 

NSOLE ENTRY VECTOR 

OLE ENTRY VECTOR 

/\/\/\/\/\A/\/\/\/\/\ 



DISK INTERFACE ROUTINES 



= » = = =»;:» E No OF REQUIRED RESIDENT SPACE ============= 

FILE CONTROL BLOCK AND INTER-TRANSIENT 
COMMUNICATION AREA 

ABSOLUTE TRANSIENT BUFFER (OPTIONAL DATA BUFFER OJ 

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\ 

ADDITIONAL DATA BUFFERS 

AND SPECIAL PURPOSE TRANSIENT SPACE 

/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\ 
< > 



TOP 

-1 

-2 

-3 

-4 



-10 



C2101 



-205 


-206 


-207 


-210 


(470* 


-700 



-740 



-1340 



FIGURE 5*3. B 
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5.3.2 SYSTEM CALLS AND LINKAGES 

This section describes the general transient and subroutine f inkages found 
in NCS. Most linkages are shown below with minimal narrative. NOVA assem- 
bly language statements are used throughout the examples. 

1. Normal transient call is through LDR. Following transient fetch, exec- 
ution will depend on the type of transient called, and whether "MODE" 
is set to enable execution. Whenever execution is inhibited, transfer 
returns to CALL + 3. Return to CALL + Z occurs only when there has 
been a physical disk error returned by the disk driver routines. The 
ASCII code name for the transient to be executed is always passed as 
location CALL +1. 



CALL: 



LDR: 



JSR 


3LDR 


FUNCT 




JMP 


ERR 


JMP 


NORMAL 


TOP-2 





; CALL LOADER 

; TRANSIENT NAME 

; DISK ACCESS ERROR RETURN 

; NORMAL RETURN 

; LDR ENTRY POINT ADDRESS 



occur following completion 
type 1 transient. Each transient may 
Indicate the results of Its activity 



if the execution of a 



Normal return may occur following completion of the execution of a 

transient. Each transient may return to alternate locations to 
results of its activity: 



JSR 

♦I * 

JMP 



JMP 
JMP 



SLDR ; CALL LOADER TO EXECUTE 

J OPEN FILE FUNCTION C) 
ERROR ; DISK ERROR OCCURRED ON EITHER 

? TRANSIENT LOAD OR DIRECTORY SEARCH. 
NONE 1 RETURN HERE IF NOT ON FILE. 
FOUND ; NORMAL RETURN AFTER FILE OPEN. 



Internal transient to transient call 



LDRXS 
FUNCT: 



LDA 0, FUNCT ; SET TRANSIENT NAME IN AC 0. 

JMP 3LDRX ; CALL INTERNAL LOADER. (THERE IS NO 

J RETURN FROM THIS CALLING SEQUENCE) 
TOP-3 ; LDRX ENTRY POINT VECTOR ADDRESS. 

"Q ? TRANSIENT NAME (ASCII!. 



4. Transient exit to calling transient, using recursion 
re-entry (RECUR): 



reg i ster 



RECUR: 
LDRX : 



LDA 
M0V# 
JMP 
JMP 

17774 
17775 



CSRECUR J ORIGINAL FUNCTION CODE. 



0,0, SNR 
EXIT 
3 LDRX 



IF NONE THEN 
EXIT TO CALLER. 
RE-ENTER LOADER 
AC CONTAINS FUNCTION NAME 
RECURSION REGISTER ADDRESS 
LDRX ENTRY ADDRESS. 
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5. Standard return to calling program. Uses an internal reg'rster hold 
AC3f which is maintained at address TOP-20I : 



LDA 

JMP 
17577 



3,3AC3 
1,3 



REGISTER 3 CONTAINS DISK ERROR 
RETURN ADDRESS. 
GO ONE BETTEUr NORMAL RETURN. 
ADDRESS OF REGISTER 3 SAVE. 



AC3: 

6. Complete null executable Ctype If transient example: 

TOP -1340 



START; 



.LOC 

START 



JMP 

.END 



1,3 



TRANSIENT BUFFER BASE ADDRESS. 
ENTRY POINT ADDRESS. 
NO RELOCATION REQUIRED. 
RETURN IMMEDIATELY (NORMAL EXIT! 
NOT MUCH IS IT? 



7. End of job exit. Returns directly to system control through entry 
at EOJ: 



JMP 
17777 



SEOJ 



EOJt 

8. Output to active console 



LDA O f CHAR 

JSR SPUTC 

JMP NEXT 
TOP-207 



PUTCS 

9. Input from operator console: 



CALL MONITOR AND EXIT. 
SYSTEM EXIT CTDP-11 . 



GET CHARACTER FROM SOMEWHERE. 
WRITE TO CONSOLE. 
ONWARD-! 
WRITER ENTRY POINT ADDRESS. 



GETC: 



JSR 


3GETC 


5TA 


G,CHAR 


JMP 


NEXT 


17570 





INPUT ONE CHARACTER. 
SAVE IT SOMEPLACE. 
ONWARD! 
READER ENTRY POINT ADDRESS. 
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6 FILE FORMATS 

MICRO utilizes three disk fife types and one printer, or console, fife. 
Source files contain ASCII coded data, white binary files contain data in 

nthPr Hf^% W ? rd f ° rmat : Any dlsk based fi,e "** be moved to or from any 
other disk file using the NCS utility program "COPY". COPY wilt also move 

source character record data fEles between disk and external media such as 
r^nr' .?*??' C r dSf ° r Mstlns ""fees, binary files cannot be moved to 

ZYntrl f ill 9 d ! v ! ces ' th0U9h the " SAVE " "tUity program can retain a 
binary file on a 9 track magnetic tape. 

NCS fH^ W ncL S r UOrrS M dJsCUSS the struc tures and utilization of the four 
NCS files used during MtcroassemblUs. 

6.1 SOURCE INPUT (01 SKI FILE FORMAT 

Source program files, to be read through MICRO file INPT, must be resident 
on disk Pf.or to initiating an assembly. The data characters on the nput 

VnlL "!h.J 8 u n i!! , i-/??i!._ c ?! ,es » * h0U9h MICR0 wMl '^nore any control 

y 
" c 

d 

"cord'c^ b fM^ V- ,n, °'"?* 1 ™ PoTnir-it^endrioT.^.ng^; enTof 
1*6 01 red;, code Use!f! "* ^ represented *>* a '»"«»■ character, the 

?I^°/ ea ^ S IH !!T ! Me data one eharacter at a time. Each time an end of 
record code, which is an ASCII (015, octal) Carriage Return control code, 
is encountered the assembly process begins on that record. Once all 





missing. Records containing more than 80 characters will be processed as 
80 character records, with all excess characters being discarded. 

»°r" !-?!.^ ara< 1 ters .? re «apped into their upper case equivalents. Any 



ASCII control codes other than "Carriage Return" (0151 will be iqn 
Refer to APPENDIX A, CHARACTER SET, for additional details. 



or ed 



6.2 BINARY OBJECT (DISK! FILE FORMAT 



b t Lrdi th n m , f r te . f0rmat consfst s of binary blocks, made u P of 16 
d sk 1l\„ ! BIN f i'! lS °P tiona ^ and when selected must be placed on 
disk. It may be moved to other disk files by the COPY utility program. 
rtr^A * ransported ' ° r backed up, on magnetic tape using SAVE, or on 
Cartridge tape using the DISCART utility. Its content may be read by ?he 

"G^D^n^ l th der ^ D -: bV the ^/5YSTEH microprogram loader facility 
wnld r or by the cartridge tape program writer "PREP". 



QM 
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Two types of binary blocks will be generated by MICROr Data Blocks, and 
Start Blocks* Data blocks contain up to 16 NOVA data words, or up to 8 
microprogram C18 bitl data words. Start blocks are of a fixed length, and 
contain the optional program entry (start! address. A start block will 
cause termination of loading* or writing* when encountered by any of the 
object file processors. Other forms of block structures found on a BIN 
file will be skipped over* bemg terminated when a binary zero datum is 
read. A f I Data and Start blocks contain checksum words. If a checksum is 
found to be incorrect an error message will be written to the console. 

Data blocks for NOVA type programs contain 16 bit, block load addresses. 
When a data block contains microprogram (18 bit) words each 1.8 bit word is 
written to the Data Block as two 16 bit words, 10 bits in the first word 
and 8 bits in the second. To allow for proper handling of this format the 
block load address must be multiplied by 2, thus restricting absolute block 
foad addresses to a maximum value of 32,767 (77777 octal). This is a re- 
striction on MICRO version 1.3 only. The following diagram shows the for- 
mat of data and start blocks. 



DATA BLOCK FORMAT 



START BLOCK FORMAT 



1 I -WORD COUNT CWC1 I 
j. 1 

2 I LOAD ADDRESS I 

! . 1 . 

3 I CHECKSUM WORD I 

r 1 : 

4 I DATA WORD 1 I t W 
I — i : o 

5 I DATA WORD 2 I : R C 
I 1 : d 

/\/\/\/\/\A/\/\/\ « U 

I 1 : n 

WC+3 I DATA WORD WC I : T 



1 



1 I 
I 

2 I"S" ADDRESS 

r 

3 I CHECKSUM WORD 



The "S" flag in the Start Block (bit position 151 indicates whether the 
"ADDRESS" field contains an entry point (start) address, for use in NOVA 
program loading. S = wi I I allow loader transfer directly to "ADDRESS". 
5 = 1 will cause the loader to HALT after loading. 



The word count of a Data Block is 
two's complement negative format. 



retained in word 
Word count CWC) 



1 of that block, in 
may be from 1 to 16 



Following the Start Block, MICRO will pad the remainder of the BIN disk 
file with binary zero fill words. If the size of the BIN file is too sma 
to contain the entire object program, MICRO will display an error message 
on the system console. The object file will be unuseable in this case, 
though MICRO will complete the remainder of the assembly 
additional BIN output. The error message displayed is: 



th i s 
w i thout writing 



*** BINARY OUTPUT FILE FULL *** 
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An object nanoword may be completely represented in NOVA memory as 
word pair array* called the Nano-Ugf cal-Array ' ' memory as 




NANQ BINARY BLOCK HEADER 

1 |--!™L T * pe J Symbor length I (Characters) 

2 I Character 1 * Character 2 I 

/\-A^/W/WWWV_/W\_/\ 

6 I Character 9 ! Character 10 I 

7 I Nanoword address or constant I {Absolute} 

8 i.5™I!Lii!lL!-I'?!L!l W ° Fd l (TyPe * MICRD IDENTIFICATION] 

9 I (Reserved} i {Reserved} !X XI 
I . , i , { 

10 { s .!2!!!!l !S ^.[!!!! a I n ? e [_ of ^ < [ ock l <In 16 bjt words} 



QM 
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HEADER TYPES: 



= Last Header, end of DEFINITION file 



External Constant description. Always has a Length of 
The actual value is in the Nanoword address field as a 
which is < 2**18, The high order 2 bits of this va' 
the X X portion of word 9. 



10 words, 
number 
u e are in 



of the Nanoword, 
and the Charac- 



Nanoword Record Header. The Symbol is the name 

(has symbol length when the word has no namel 

ters are the first 10 ASCII symbols from the source Nanoprogram 

Nanoword LABEL. The address is the actual QM/SYSTEM Nanostore 

address. The Type field contains the microinstruction format 

decl arat t on. 



Fig. 6.3. B 

NANDWORD 



RECORD ELEMENT 



FIELD VALUE I 
...--I- 1 

AtEl Offset t 6 / 12 Word I 

« ». Shift r Displacement I 

i 1 

Field (6/12 bit! Mask I 
. 1 

Construction array I 

FIELD NUMBER I 



The FIELD VALUE is the binary value to be placed into the appropriate 
Nano-Pr im cti ve field. The Offset Shift is the amount that the Field Value 
should be Left Logically shifted into position for the 6/12 bit NOVA- 
Logical-Array word. The Field Mask is a 16 bit mask to be ANDed (after 
the shift) with the field value. The 6/12 Word Displacement is the indi- 
cation of which word in the NOVA-Log i ca I -Ar r ay this Field Value belongs. 
The Construction Array field number refers to a descr ipt i on tab le in the 
Nanoassemb I er itself. 



Notes* 



Fields "A" and n E M are internal assembler flags. 
The real word values are set for the construction of each 
nanoword as 20 sets of word pairs, for NOVA implementation 
Each pair represents an 18 bit QM-1 word, with the left 6 
bits right justified in the first NOVA word and the right 
12 bits right justified in the second NOVA word. 

Nanoassemb I e r does no modular arithmetic. The Field 



3. The 



Mask 
is tor thatpurpose ? tt permits the nanoprogram loaders to simply 
insert the Nano-pr i mi t i ve into the appropriate field. 



QM 
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« i i i t t 

M t t t t 



Fig : i r t t: 3( : nova-logical-array data word pair 

NOVA (16 bit} TWO WORD FORMAT MAPPING INTO GM/SYSTEM (18 bit) FORMAT 
NOVA WORD 1 MOVA WORD 2 

l\\\\\\ uxx Left [ tu ^ Right i 

[VWWWWA 6 } [\\\\ i 2 J 

1 1 1 1 1 1 i i 1 1 j » 

J J I I J { J f t I J J 
! I I I I I I « J { r * j i j i » f 

****»» ! f !' I f ! I I I * * J 

z & t . 1 1 1 i » t j * » r * 1 1 t r 

l i ! ! ! I I t ! J ! S I I i i I J 

. ~ - -—._-_= J 

I 18 B It QM Word J 

I J 

\\\\\ Represents unused area* 

6.4 SOURCE LISTING (PRINTER /CONSOLE } FILE FORMAT 

The full mlcroassembty. source program Listing may be output to either the 
ne Printer or system console. Each source line is divided into Six 

sp^e llnTZl t*J P /^l character position 1. A.I numer Ic Til I ds ar e 
displayed in 6 octal diqit notation.. Tho iin f~. m o+.~ , _ r * _ 



Field: 1 2 3 4 S 6 

000000 HUH ZZ2Z22 333333 444444 SOURCE STATEMENT IMAGE > 

MACHINE INSTRUCTION Statement: 

023472 620001 023473 LABEL: B . + 1 

Hi^LfZ+i'* l IS * l "** s the Instruction address* Fields 2 and 3 will 

a ™% on !.? r Wa WOrds that wm beG0 ^ the actual object Initruct ion 
Zl IL - +* W I contaln the effective absotute storage address referenced" 
by any instruction* containing instruction-counter relative OPERANDS 



GM 
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PSEUDO OPERATION statement: 

000077 MASK = 77 

010333 027102 046113 00000 CODE; .TXT /.BLK/ 

010000 777777 777777 777777 777777 FIELDS: .BLK 9.*-l 
777777 777777 777777 777777 



777777 




DATA statements: 

000100 000000 000001 000002 000003 CONSTANTS: 0, I* 2* 3, 4* -1 

000004 mm 

Where the format is similar to data generated by .BLK statements, above. 

Error conditions detected on a statement villi be displayed on the following 
line. Errors are flagged as single letter error codes* with the code letter 
usually appearing under the leftmost position of the particular element in 
error. When a field is incorrectly structured* or an entire statement ts 
bad* the code letter may appear at the end of the erroneous field or state- 
ment, respectively. 

Examples of errors on a statements 

002310 000100 002032 LABEL LD 10*32 $ COMMENT 2000 

*** ERRORS FOUND IN LAST SOURCE LINE U U F U 

002312 321000 000000 NAME: STD 10*SAVE* COMMENTS. 

*** ERRORS FOUND IN LAST SOURCE LINE I 

Where the letter "U" indicates that the NAME is undefined, "F" is a format 
error, "I" is an illegal field value* and "0" indicates missing operands. 
Error messages are detailed in APPENDIX B, MICROASSEMBLER ERROR MESSAGES. 
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7 OPERATING PROCEDURE 



KSiSn" tZZ'Tl s:^ US """>»"•"• The g ene raf for.at of S^^" 

tMA-optionsrDEF-def in it ionf it es, IWPT=sour cef i I es, B IN = ob jec tf tie. 

The »!« character is the NCS command state prompt symbol, and indicat 
that a program name may be entered. MICRO Is initiated by the progra 
file name "MA". The parameters are expfained in detail below. 



es 

m 



7.1 PREPARATION OF SOURCE INPUT FILES 

When a source Program file is prepared in card format it may be copied to 
disk using the NCS utility program COPY. The source and object program 

In! 6 nthp? . ?• -* Ined J USiR9 the FRES utmt * Program, before beginning 
any other activity. A source program may be split into separate components 
for use as OVERLAYS or SEGMENTS by the various systems available^ When 
there are common symbols or definitions to be referenced by the components 
of a program, these may be separated from the actual program source files. 
Once ait source files are ready, they may be specified to MICRO as follows 



INPT = pr imaryf i le+def initi on3+def in t 1 1 on2 + def initi on 1, 




Def inition file: 

D .TITL DEFINITIONS AND COMMON SUBROUTINES 

D .LOC 100 

D / Common Subroutine Code and symbolic constants \ 

D < defined here for reference by primary object > 

D ^ program uti I i zat ton. / 

D \ . _ _ / 

D ORIGIN * ; DEFINE END OF SUBROUTINES SECTION 

.END 
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Pr imary file: 

p .TITL ONE PROGRAM OVERLAY SEGMENT 

P .LOC ORIGIN ? BEGIN AFTER SUBROUTINES SECTION 

p /__ „ . \ 

p / Main program SEGMENT* which will call on \ 

p < elements of the common Subroutines section. > 

P \ Subroutines may be referenced directly by name./ 

p \ __ / 

p .END START 

ICOPY, *CDR„D. 

!COPY,*CDR y P. 
!MA,DEF=,INPT*P+D,BIN=. 



7.2 PREPARATION OF DEFINITION FILES 

DEFINITION files are produced as output from Nanoassemb I i es . They contain 
instruction set definitions as welt as symbolic constant NAMES. One or 
more of these files must be used when performing a m icroassemb I y . The 
following is the format of the DEFINITION file parameter. 

DEF=def in i tion4+def in i t ion3 + def ini t ion2+def in i t ionl , 

Specifying no DEFINITION file is accomplished by following the DEF= with 
any standard NCS delimiter character, such as space " " » comma "»" or 
period "•". The order of specification for multiple DEFINITION files is 
unimportant unless there may exist multiple definitions of the same symbol 
In that case the symbol encountered first* from the rightmost file name, 
will be the symbolic value used. 



Ex amp I est 



Lower case lettering represents operator keyed data 
Assembly with no definitions (NOVA!. 



!copy?*tpc0)tsource. 
!ma,DEF-> INPT= sour ce , BIN=ob j . 



<CREATE SOURCE DISK FILE> 
<ASSEMBLE SOURCE TO OBJ> 



Assembly with multiple definitions. 

!copy,*cdr, source. <CREATE SOURCE DISK FILE> 

ima,DEF=sysdef + use r nano * I NPT = scur ce»B I N=ob j . 

<ASSEMBLE SOURCE TO OBJ> 



7.3 ASSEMBLER INVOCATION OPTIONS 

When MICRO is initiated, by entering the tetters "MA", it will produce an 
assembly with full source program listing on the system printer. Several 
options are provided for reducing or altering that listing. 

The standard full listing will display all input source lines, additional 
lines showing error codes, and finally an operation code and symbol table 
list following the assembly. Options are provided that will permit dele- 
ting all listing, unconditionally, or deleting only parts of the listing. 
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!! ^° Mtrtln 63 tn L error are desired, or the symbol table fist is not 
«?rpn In I CR ?. may be inf o«-med of these listing options by following the 
hi on. „l * ? ^f 6 Wt ! h a hyphen character. The hyphen is then followed 
by one or more I ette r-o P t . on codes, as described in the following sections. 

!MA-options,. . . 



7.3.1 A - SELECT ALTERNATE DEVICE (CONSOLE) 

Option »A» causes all material that would normally be transmitted to th 

system printer to be displayed on the system console. When a hard copy 

s ,n use th »s provides an alternate fisting device 



conso I e 



IZ- *• Fiuviaes an alternate ristmg device. In general, 

this optron provides a quick method for displaying assembly errors, when 
the additional option is selected to suppress all but erroneous lines. 
Selecting this option also deletes listing of the operation code and symb 



tab I es 



ol 



7.3.2 X - SUPPRESS SYMBOL TABLE LIST 

The alphabetically ordered operation codes fisting, and general symbol 
taoie listing, will be suppressed. Only source statement listings will b< 
produced, tf selected. Selection of option "A" will also suppress thes- 



7.3.3 N - NO LISTING, DISPLAY ERROR LINES ONLY 

When »N» is specified, source statement lines will not be displayed unless 
that line contains one or more error conditions. Fo 
error will be an error code line, as shown 
option has no effect on any other option, 
override this option. 



ow i ng each line in 
in section 6.4, above. This 
Only option "L", see below, will 



7.3.4 L - SUPPRESS ALL LI STABLE OUTPUT 

Option "L" will override any other option specifications. No fisting will 
be produced on any device. Error lines will also be suppressed. The only 
indication of error conditions occurring will be a console message produced 
at the end of the assembly: 

ASSEM. ERRORS 



7.4 BINARY OBJECT FILES 

An object program file will be produced when specified as the BIN file 
parameter. Only one object file may be produced per assembly. Object 
tile production may be suppressed by following the BIN parameter with an 
NC5 delimiter character. There is no recorded identification within the 
object file, to distinguish between NOVA type and microprogram type objec 
ti es. Care must be taken to Identify these files externally, usually by 
III* ? af J! attrtb "te S . The remainder of this section briefly describes th 
use or the various loaders to access object files. 
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ima-n, DEF=sysdef , I NPT=myprog :sou , BIN=mypr og sobj . 

7.4.1 MICROPROGRAM OBJECT FILES 

Microprograms may usually be loaded in either of two available ways. 
Directly from disk object fife residence, with several constraints placed 
on storage allocations, and from Cartridge Taper with no constraints. The 
next two sections discuss the features and options available with these two 
methods. 

7.4.1.1 "QMLD" MICROPROGRAM LOADER 

"QMLD" is an NCS utility program, which utilizes the QMLDR nanoprogram 
loader system. One or more disk files may be merged together into a re- 
served Main Store area, one for each of the QM/SYSTEM storage classes. 
With QMLD, either object code or data may be loaded into Main Store loca- 
tions through 13777 (octal!. Microcode and data may be loaded into Con- 
trol Store locations through 17777 (octal]. And finally, Nanoprograms 
may be loaded into Nanostore from nanoword location to 674. QMLD is 
fully described in the NCS OPERATIONS GUIDE. 

7.4.1.2 ••PREP" CARTRIDGE TAPE PREPARATION 

The NCS utility program "PREP" provides the capability to record Cartridge 
Tape object program files, which can be loaded into the GK/SYSTEM memories 
using the standard Read-Only-Memory boot loader system. The combination of 
the ROM boot loader and PREP program provide the user with the ability to 
preset or clear areas in any of the storage regions* load program and data 
modules into any of the regions, and finally to initiate microprogram exec- 
ution via transfer to either a nanoprogram or microprogram entry point* 

The Read-Only-Memory boot loader Is a Nanocode - Microcode environment, 
which may be interfaced through writeable Nanostore or Control Store to 
enhance loading capabilities. Additional information on the use of PREP 
and ROM is provided in the NCS OPERATIONS GUIDE. 

7.4.2 "NOVA" FORMAT OBJECT FILES 

A NOVA format file may be loaded directly into Main Store under NCS control 
using the program loader U LD M . LD will read the object file and place data 
from the Data Blocks (see section 6.2, above! into the specified storage 
locations. If an entry address had been included on the .END statement of 
the original assembly, then control will be transferred to that address at 
the end of loader operation. LD may be used as follows: 

!LD,(*)filename(-displacementy. 

Where the optional asterisk (-! will indicate to LD to suppress execution 
of the program even though an entry address has been provided. The nega- 
tive displacement parameter is also optional, and forces all Data Blocks 
to be loaded lower in storage by the octal value "displacement". This 
allows maintenance of special NCS component programs. Once a program is 
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loaded in NOVA format Main Store it may be recorded on disk as an absolute 
system overlay program, using the following commands! absolute 

!$fttename ENTER (Y) TO WRITE 



^prig^Sri'Mrth^n 1 ??^ K y ? h + e FILES Utinty Program, to be an absolute 
thT- « the ab soJute program will be recorded on that fir* 

Th.s program may then be executed directly by NCS, by simply Specifying, 
program file name as a command to NCS. P y spec f y ' ng th( 



i f i I ename 



QM 
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APPENDTX A* CHARACTER SET 

Characters are stored internally as two 8 bit characters packed from teft 
to right in a 16 bit word* The internal character set of MICRO is 7 bit 
ASCII right justified and zero padded within the 8 bit field. The table 
below gives the octal encoding of the characters, their normal associated 
graphic symbol and a statement of usage where appropriate. 



040 

041 

042 

043 

044 

045 

046 

047 

050 

051 

052 

053 

054 

055 

056 

057 



space 
i 

it 

n 
$ 
% 

t 

* 

( 
i 



060 





061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


7 


070 


8 


071 


9 


072 


* 


073 


• 


074 


< 


075 


= 


076 


> 


077 


? 



100 


3 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 


110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 






120 

121 

122 

123 

124 

125 

126 

127 

130 

131 

132 

133 

134 

135 

136 

137 



P 
Q 
R 
S 
T 
U 
V 
W 
X 
Y 
Z 



End of Record 



NCS 
bit 



Characters are extracted from the NCS file INPT one at a time, using an 
disk utility program. MICRO assumes that the characters may have any 7 
vafue and performs the following transformation: 

CR (015) translated to EOR (1371 
UA (1361 translated to EOR (137) 
140 - 177 translated to 100 - 137 
Other codes 000 - 037 ignored. 

Using these transformations, an input line is produced up to and including 
an EOR (End Of Record) resulting from either CR or UA. 
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APPENDIX B. MICROASSEMBLY ERROR MESSAGES 




B.l MICROASSEMBLY CONSOLE ERROR MESSAGES 
1* A5SEM. ERRORS 

Indicates that one or more statement or processlna error, ha* 

nTend VtV h : a *"«"""""*• This message wltTL P uc %t 
. v . e complete assembly process, whether or not an 
assembly listing was produced. 



IAKE 

An illegal f f fe name Has entered during assembl invocation 
file name must be re-entered. invocation. 



3. BINARY FILE SIZE * <octai value> 

Til object proara™ 9 ?i,rhi nf K rmatiVe meSSa9e lsSUed onl * aft " the 

?he ta :;??re a : DJ -::rp e ro en jLi he numb " of disk — s - q ui7er f o°r ta 

4. *** BINARY OUTPUT FILE FULL «** , 

IrL B,N TK faJeCt f ^ te ls t0 ° sma " t0 contain the entire object pro- 
9 am. The assembly will run to completion, though the object f Me 
""' be ""MSMble. The assembly must be re-run on a larger file! 

5. * DEFINITION FILE ERROR. 

fi»Il2 r ?.f hy81 "! disk error Qr a structural format error has been 
<n T,t ,'l e re ** ,n 9 a DEFINITION file. This message wi? be 
followed by a "MALFUNCTIONS" message, see (81 below! 

6. DUPLICATE DEFINITION - <name> 

on thTconso" T^ v'a I u l\T t L° . ohtmn"? ' I?******" ' ia ^»wn 
the NAME will be retained and used. ' fSU occurrance °' 

7. FILE NOT FOUND 

During assembler invocation, a file name either does not exist or 
re-enterer 0rreCt,y e " tered " the COnSOle ' The "«• «st b2 

8. MALFUNCTION: 000000 Illin 222222 333333 

w?M P ^m!"!h I/D d6ViCe error ' or internal assembler malfunction, 
will cause this message to be issued. The internal NOVA registers 

I ! !™ 1 nif^? St!C Purposes. The octal value found in " 
digit string 111111 will usually be an NCS I/O error code. 



QM MICROASSEMBLER REFERENCE MANUAL NANODATA CORPORATION Ed.l Page 0052 

9. SYMBOL TABLE OVERFLOW m 

Too many symbolic NAMES have been specified duF i ng the assembly. 
A larger version of MICRO will be necessary in order to continue. 

B.2 MICROASSEMBLER STATEMENT ERROR CODES 

Statement errors will be indicated on the line printed immediately below 
the source statement line containing the actual errors. AM statement 
error codes are single letters, usually placed directly below the element 
or field in error. When an entire field specification is incorrect the 
error code will be placed below the field terminator. The following are 
descriptions of all error codes and their affects on the assembly. 

A - Addressing error. The evaluated address was not wtthii\the 

range - 377 (octal* for absolute NOVA fields, of within +200 
or -177 Coctall locations from the current instruction address 
for location-counter relative fields. 

BLOCK C.BLK) statement block size OPERAND value is greater than 
2**18 - I (262,143). The block will be allocated anyway, through 
the micro-location-counter will usually wrap around into previously 

at located areas. 

Comma missing between required OPERANDS. Processing continues as 
if the comma preceeded the point of error detection. 



B - 



C - 



e 



D - NOVA Device Identification field is in error Cmtssing of valu 
greater than 63.1 Zero is inserted in the device code field. 

E - Address of object microcode exceeds 2**15 - 1 {32,767) . The 

address generated will be modulo 32,768. This error will not be 
detected unless a binary file is being produced. 

F - Illegal Format. Any special character code that is not recognized 
as a supported OPERATOR. The character is ignored, except that it 
will delimit any NAME or NUMBER element to which it is appended. 

I - Invalid accumulator. OPERAND EXPERSSION value was greater than 3 
or less than 0. Zero is inserted in the accumulator field and 
statement processing continues with the next field. 

L - PSEUDO OPERATOR not currently supported (will be Later.! 

M - Multiple definitions for the flagged symbol. The first occurrance 
of the symbol will be used. 

N - Nufi text string generated by a .TXT class statement. One word of 
zero will be generated. 

- One or more required OPERANDS are missing. Statement processing 
will terminate. 

P - Phase error. Symbol has different values for PASS 1 and PASS 2, or 
cannot be located during PASS 2. Processing continues. 
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Q - 
R - 
S - 

T - 

U - 

V - 

X - 

Z - 



Inn^VatTSZ 'uTd erf0r * ° PERAND EXPRESSI °N value is not 

ed^nto "IWiVuVX '" MDVA tyPe '"^"ct'on. Zero is insert 
Too many OPERAND fields specified on a statement. 

Undefined symbolic NAME, or this syfnbof was EQUATED to a ,„i,„, 
which was undefined in PASS 1. A zero value is substituted 
Reference to a multiply defined NAME will a I so r Ice ill this "er ror . 

?he R neld a, a U nd OV rr 0WS ° bj6Ct fiefd - A zero value is placed into 
the freld, and statement processing continues. 

PSEUDo'oPER^nR^T - Symb ?' iS alrea ^ ^ OPERATION CODE or 
Pro E ces S ?ng R conu'nues! er ° ^ ''* «">*"*«"• "d EXPRESSION 

Numeric item contains digits not cnn^.t^t ,,; + * +u 

fha<?f»i Th Q ^« »*• a us n0T - consistent with the current radix 

an%^ , g i t^%^ a *nrthe m Tn f e C S ir^ 9 ^: ! "* the ^^ ««" - 



QM 
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APPENDIX C. PSEUDO OPERATION LIST 

The following list contains a brief description of each PSEUDO OPERATION 

supported under the MICROASSEMBLER* 



,RDX <Expression> 

.LOC <Expressron> 

.BLK <Expression> 

.BLK <Expresslon> f <'Expression> 

.TXTM <Expression> 

.TXT 
.TXTO 
.TXTE 
.TXTF 

.XPNG 

.TITL <Character String> 

„IFN <Expression> 
. IFE <Expresston> 

• ENDC 

EJECT 

LISTON 
LISTOFF 

.EOT 

.END 

.END <Expression> 



SET NEW RADIX FOR NUMBER CONVERSION 

SET NEW VALUE OF LOCATION COUNTER 

RESERVE BLOCK OF MEMORY or 

SET BLOCK OF MEMORY TO A CONSTANT VALUE 

SET TEXT MODE 

PROCESS TEXT STREAM WITH ZERO PARITY 

PROCESS TEXT STREAM WITH ODD PARITY 

PROCESS TEXT STREAM WITH EVEN PARITY 

PROCESS TEXT STREAM WITH ONE PARITY 

DELETE PREDEFINED OP CODES 

SET UP TITLE FOR DISPLAY IN PAGE HEADING 

CONDITIONAL ASSEMBLY IF NOT ZERO 
CONDITIONAL ASSEMBLY IF ZERO 

END CONDITIONAL ASSEMBLY SKIP 

FORCE NEXT LINE TO BE ON A NEW PAGE 

ENABLE LISTING MODE 
DISABLE LISTING MODE 

END OF INPUT SEGMENT 

END OF SOURCE or ^^cc 

END OF SOURCE WITH STARTING ADDRESS 
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